/**
 * Copyright(c) 2014 Xunton Solutions
 *
 * History:
 *   15-12-12 下午1:47 Created by dwzhang
 */
package com.jade.bss.base.customer;

import java.util.List;

import com.jade.framework.base.criterion.Criteria;
import com.jade.framework.base.util.PagingList;

/**
 * 地址管理器接口。
 *
 * @author <a href="mailto:dwzhang@xunton.com">dwzhang</a> 
 * @version 1.0 15-12-12 下午1:47
 */
public interface CustomerAddressManager
{
    /**
     * 新增一个客户地址。
     *
     * @param address 地址信息
     * @throws CustomerException 处理异常
     */
    public void addAddress(CustomerAddress address)
            throws CustomerException;

    /**
     * 更改一个客户地址。
     *
     * @param address 地址信息
     * @throws CustomerException 处理异常
     */
    public void updateAddress(CustomerAddress address)
            throws CustomerException;

    /**
     * 设置地址为默认地址。
     *
     * @param customerId 客户标识
     * @param type 类型
     * @param id 默认地址标识
     * @throws CustomerException 处理异常
     */
    public void setDefaultAddress(long customerId, String type, long id)
            throws CustomerException;

    /**
     * 删除一个地址信息。
     *
     * @param ids 地址标识
     * @throws CustomerException 处理异常
     */
    public void removeAddress(long... ids)
            throws CustomerException;

    /**
     * 根据标识获取地址信息。
     *
     * @param id 地址标识
     * @return 地址信息
     */
    public CustomerAddress getAddress(long id);

    /**
     * 列出一个客户一种类型的所有地址。
     *
     * @param customerId 客户标识
     * @param type       地址类型
     * @return 地址列表
     */
    public List<CustomerAddress> listAddress(long customerId, String type);

    /**
     * 根据条件查找客户的地址信息。
     *
     * @param customerId 客户标识
     * @param criteria   查询条件
     * @return 客户列表
     */
    public PagingList<CustomerAddress> queryAddress(long customerId, Criteria criteria);

    /**
     * 根据条件查找客户的地址信息
     * @param criteria
     * @return
     */
    public PagingList<CustomerAddress> queryAddress(Criteria criteria);
}
